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PREFACE 


This  installation  guide  covers  the  work  performed  under  Air 
Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base.  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker.  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Allan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents . 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors  Role 

Boeing  Military  Aircraft  Reviewer 

Company  ( BMAC ) 

D.  Appleton  Company 
CDAC0M) 


General  Dynamics/ 
Ft .  Worth 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
models 


i  i  i 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4.5  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Conpany  (BMAC) 

Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
CCDC) 


D.  Appleton  Company 
(DACOM) 


Role 

Responsible  for  factory  view 
function  researoh  (IITRI) 
and  information  models  of 
small  and  medium- size  business 

Reviewer 

Responsible  for  factory  view 
function  and  information 
models 

Responsible  for  IDEP2  support 
Responsible  for  IDEFO  support 


Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 


Responsible  for  the  overall  CDM 
Subystem  design  integration  and 
test  plan,  as  well  as  part  of 
the  design  of  the  CDM  (shared 
with  CDC  ) .  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 


Role 

Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  8  Dodge) 


Sof Tech ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Subcontractors  and  other  prime  contractors  under  other 
projects  who  have  contributed  to  Test  Bed  Technology,  their 
contributing  activities  and  responsible  projects  are  as  follows: 


Subcontractors 


Role 


General  Dynamics/ 
Ft.  Worth 


Responsible  for 
factory  view 
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Contractors 

I CAM  Project 

Contributing  Activities 

Boeing  Military 
Aircraft  Company 
(BMAC) 

1701.  2201. 
2202 

Enhanceaents  for  IBM 
node  use.  Technology 
Transfer  to  Integrated 
Sheet  Metal  Center 
(ISMC) 

Control  Data 
Corporation  (CDC) 

1502.  1701 

IISS  enhanceaents  to 
Conaon  Data  Model 
Processor  (CDMP) 

D.  Appleton  Coapany 
(DACOM) 

1502 

IISS  enhanceaents  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  oonauni cat ions 
equipment . 

Hughes  Aircraft 

Coapany  (HAC) 

1701 

Test  Bed  enhancements 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502.  1701, 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
C0I/VTI) 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 

vi 
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SECTION  1 


INTRODUCTION 


This  guide  accompanies  the  Release  1.8  of  IISS  for 
installation  on  an  IBM  MVS  computer.  It  provides  the 
instructions  for  installing  the  IISS  Network  Transaction  Manager 
(NTM)  and  Communications  to  a  VAX  computer  running  IISS. 


v»'v'v 
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SECTION  2 

NECESSARY  HARDWARE  AND  SOFTWARE 


The  following  system  hardware  and  software  should  be 
sufficient  for  the  installation  and  operation  of  IISS.  It  is 
possible  that  lower  versions  of  some  software  may  be  sufficient. 

IBM  4341,  303X,  or  308X 

150  Cylinders  3330  Disk  Space  or  equivalent 

1600  BPI  tape  drive 

MVS/SP  1.3  or  MVS/XA 

Assembler  H  Ver.  2 

COBOL  VS  R2.3 

'C‘  Compiler 


ACF/VTAM  Ver .  2 
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SECTION  3 

CONTENTS  OF  MAGNETIC  TAPE 


The  fornat  of  the  release  tape  for  the  IISS  IBM  is  an  ANSI 
labeled,  9-track  tape  written  at  1600  bpi .  It  is  a  nulti-file 
tape  with  each  file  having  the  foraat  of  an  IEBUPDTE  input  data 
streaa.  Each  file  has  a  logical  record  length  of  128  bytes  with 
a  blocksize  of  2048  bytes. 

At  the  present  tine  all  prograa  source  record  length  is  80 
characters  or  less;  therefore  the  installation  JCL  will 
truncate  the  128  byte  records  to  80  byte  records  for  the 
appropriate  compilers. 
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SECTION  4 
INSTALLATION 


(1)  Create  the  following  JCL  and  submit  to  download  file  1 
to  disk  from  the  tape.  This  file  contains  the  JCL  needed  to 
continue  the  IISS  installation. 

//IISS  JOB  (AGCT.'IISS  SYSTEM'), 

//  PRTY-07.CLASS-A. TIME-3, MSGCLASS-A 
//***»*****************»********* 
//*  CREATE  JCL  BUILD  DATASET  * 

//***»*»****»•********»*•**»»***» 
//•REPLACE  DATASET  NAMES  WITH  YOUR  INSTALLATION  SPECIFIC  NAMES* 


//••••« 

//DOWNLOAD 

PROC  IISS- 'IISS' , 

•  l 

% 

IISS  SYSTEM 

HIGH  LEVEL  INDEX 

// 

R-R18' , 

% 

IISS  RELEASE  LEVEL 

// 

SUNIT-  TAPE9' . 

• 

SOURCE  TAPE 

UNIT  NAME 

// 

SVOL- 'IISS 16' . 

* 

IISS  TAPE  VOLUME  SERIAL  NUMBER 

// 

DUNIT- ' 3330 ' , 

* 

DESTINATION 

DASD  UNIT  NAME 

// 

DVOL- ' IISS01 ' 

* 

DESTINATION 

VOLUME  SERIAL 

/ /STEP1  EXEC  PGM- IEBGENER, REGION-5 12K 
//SYSPRINT  DD  SYSOUT-A 

//SYSUT1  DD  DSN-FOR007.DAT, DISP- (OLD, KEEP), 

//  LABEL- ( 1 , AL) .UNIT-HSUNIT.VOL-SER-SSVOL, 

/ /  DCB- ( LRECL- 128, BLKS I ZE-2048 , RECFM-FB , OPTCD-Q ) 

//SYSUT2  DD  DSN-0BTEMP. DISP- (NEW, PASS), 

//  DCB-(LRECL-80, RECFM-FB, BLKSIZE-3120) , 

/ /  SPACE- (CYL ,(5,5), RLSE) , UNIT-SYSSQ 

//STEP2  EXEC  PGM-IEBUPDTE .REGI0N-256K, PARM-NEW 
//SYSPRINT  DD  SYSOUT-A 

//SYSIN  DD  DSN-UHTEMP, DISP- (OLD, DELETE) 

/ /SYSUT2  DD  DSN-ffUSS.  .©R.  .BUILD, DISP- (NEW, CATLG, DELETE). 

/ /  DCB- ( LRECL- 8  0 , RECFM - FB , BLKS I ZE - 3 1 20 ) , 

/ /  SPACE- ( CYL ,(5,5,20), RLSE ) , UNIT-&DUNIT , VOL-SER«©DVOL 

//  PEND 

/ /STEP1  EXEC  DOWNLOAD, R- ' R18 ' .DUNIT-’ 3380' , 

//  SUNIT- ' TAPE9 ' , SVOL- ' IISS 16 ' ,DVOL-  D80036' 

//STEP1 .SYSIN  DD  • 

GENERATE  MAXFLDS-1 

RECORD  FIELD-( 80) 

//• 


The  'BUILD'  dataset  just  created  now  contains  the  JCL 
necessary  to  install  IISS.  The  user  must  modify  the  JCL  to  meet 
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his  installation  specific  requirements. 

(2)  It  is  first  necessary  to  create  the  partitioned 
datasets  (PDSs)  that  will  contain  the  IISS  source  programs.  This 
is  done  by  submitting  the  member  BLDSPDS  of  the  BUILD  dataset. 

(5)  Once  the  PDSs  are  built,  the  PDSs  are  loaded  with  the 
IISS  source  programs  by  submitting  the  member  SRCLOAD. 

(4)  Submit  member  BLDLOAD  to  create  souroe  member  load 
libraries  that  will  be  used  for  linking  the  source  programs. 

(5)  Members  IISSASM,  IISSASR.  IISSCOB,  IISSCCX,  IISSFOR, 
and  IISSLNK  are  used  by  the  compilation  steps  of  the 
installation  and  must  be  installed  into  a  system  procedure 
library  such  as  SYS1 .PROCLIB. 

(6)  Member  IHCPGEN  of  the  IPC  library  identifies  to  IISS 
the  VTAM  application  name  for  IISS  Inter  Host  Communications  and 
the  terminal  nodename  of  the  communications  link  to  the  VAX. 
Modify  this  member  to  your  installation  specific  VTAM  names. 
Additional  information  may  be  found  in  the  section  titled 
'Inter-Host  Communications  Installation'. 

(7)  All  members  of  the  BUILD  dataset  beginning  with  'CL'are 
JCL  to  perform  compilations  of  the  IISS  source  code.  These 
members  may  contain  multiple  JOB  cards;  therefore  modification 
may  be  necessary. 

-  Submit  member  CLIPC18  to  compile  the  IBM  system 
primitive  routines. 

Submit  member  CLC0MM1B  to  compile  the 
communications  application. 

-  Submit  member  CLNTM18  to  compile  the  NTM  programs. 

-  Submit  member  CLCDM18  to  compile  the  CDMP  utility 
programs . 

-  Submit  member  CLUI18  to  compile  the  User  Interface 
routines . 

(8)  Submit  member  FLCREAT  to  create  the  IISS  runtime 

1 ibraries . 

(9)  All  member  of  the  BUILD  dataset  beginning  with  'LK' 
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are  used  to  link  the  source  programs  into  the 
executable  load  modules. 

-  Submit  member  LKIPC18  to  link  the  IBM  primitives. 

Submit  member  LKC0MM18  to  link  the  communications 
application. 

-  Submit  member  LKNTM18  to  link  the  NTM  Monitor, 

MPUs,  AP  services,  and  NTM  test  programs. 

-  Submit  member  LKCDM18  to  link  the  CDMP  utility 
programs . 

Submit  member  LKUI18  to  link  the  User  Interface 
programs . 

(10)  Submit  ALIAS  to  assign  alias  names  to  the  generated 
load  modules. 

(11)  IISS  requires  approximately  20  cylinders  of  VSAM  data 
space  for  its  message  queues  and  table  overflow 
datasets.  Define  this  data  space  to  a  VSAM  catalog  and 
modify  members  VSAMBLD  and  VSAMCLR  to  point  to  this 
VSAM  data  space  and  catalog. 

(12)  Submit  VSAMBLD  to  create  the  necessary  VSAM  runtime 
datasets . 

(13)  Submit  member  FILINIT  to  install  the  default  IBM  IISS 
parameters  into  the  runtime  datasets. 

(14)  Install  member  MSTRIIS  into  a  system  procedure 
library.  This  JCL  is  used  to  run  IISS. 
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SECTION  S 
OPERATION 


IISS  should  now  bo  started  by  Issuing  the  following  on  a 
MVS  system  console. 

S  MSTRIIS 
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SECTION  6 

IHTER-HOST  COMMUNICATIONS  INSTALLATION 


For  each  remote  host  to  be  column i cat ed  with,  you  must  code 
an  additional  IHCPGEN  module.  This  module  must  be  assembled  and 
link-edited  as  reentrant.  The  name  given  to  thi6  module  must 
match  the  terminal  id  or  port-name  the  COMM  uses  to  refer  to 
this  host.  A  VTAM  application  definition  statement  must  be 
placed  in  your  system's  VTAMLST.  The  ACBNAME  parameter  must 
agree  with  the  value  of  the  APPLID  parameter  ooded  on  the 
IHCPORT  macro.  The  format  of  an  APPL  statement  i6: 

REMHOST  APPL  AUTH-ACQ . ACBNAME -REMOTV AX 

REMOTVAX  is  the  value  coded  for  APPLID  on  the  corresponding 
IHCPORT  macro . 

The  communications  lines  connecting  each  host  must  be 
defined  and  varied  active  prior  to  starting  the  inter-host  link. 
The  label  on  the  LU  parameter  defined  by  your  VTAM  system 
programmer  must  match  the  value  coded  for  the  VTRESID  parameter 
in  the  IHCPORT  macro. 

CODING  OF  THE  IHCPORT  MACRO. 

Each  communications  link  between  two  IISS  systems  will  have 
a  load  module  associated  with  it  that  will  contain  all  the  VTAM 
control  blocks  necessary  to  establish  and  maintain 
communications.  This  module  will  have  the  same  name  as  the 
PORT-NAME  in  the  COMM  application.  It  is  created  by  the 
'IHCPORT'  macro.  The  format  of  the  IHCPORT  macro  is  shown 
below . 

IHCPORTAPPLID*xxxx,TRMID-yyyy . VTRESID-zzzz ,WAITV-nnnn ,TFLAG«ff 
where 


APPLID  is  the  name  of  the  VTAM  ACB  name  coded  in  the  VTAM 
APPL  statement.  This  application  must  be  authorized  to  acquire 
terminals . 

TRMID  is  the  port-name  passed  by  COMM  to  the  Inter-Host 
Communications  program  to  identify  this  module. 

VTRESID  is  the  VTAM  LU  name  of  the  terminal  definition 
associated  with  the  port  (i.e.,  the  label  on  the  VTAM  LU  macro 
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that  defines  the  port). 

WAITV  is  the  maximum  tine  in  1/100  seconds  that  the  IHC 
program  will  wait  for  a  response  fron  the  port.  The  default 
value  is  1000  or  ten  seeonds.  It  should  be  noted  that  this 
timeout  value  only  applies  to  waiting  for  replies  from  the  port. 
When  it  is  necessary  to  wait  for  VTAM  to  sohedule  an  event, 
there  is  no  timeout. 

TFLAG  is  a  option  to  specify  terminal  characteristics. 
Currently,  only  values  of  '00'  or  '80'  are  supported  with  '80‘ 
being  the  default.  A  value  of  '80'  indicates  whether  the  port 
will  support  VTAM  data  flow  oontrol  request  units  (DPC  RUs;  and 
other  characteristics  of  a  terminal  with  a  FM  profile  of  3  and  a 
TS  profile  of  3.  The  default  value  will  treat  the  port  as  a 
remote  3274  or  3276  SNA  terminal  and  a  value  of  '00'  will  treat 
it  as  a  local,  non-SNA  3270. 
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SECTION  7 

DATASET  NAMING  CONVENTION 


Below  are  the  default  dataset  names  that  will  be  created 
during  installation  of  IISS  release  1.8. 


I ISS. R1 8. BUILD 
IISS .R18 .LO ADLIB 
IISS .R18 . IISSCLIB 
IISS.R18. IISSHLIB 


Installation  JCL  library 
Program  load  library 
COBOL  copy  source  library 
'C'  include  source  library 


IISS.R18.IPC 
I ISS . R1 8 . NTH . MONITOR 
IISS. R18. NTH. MPU 
IISS. R18.NTM. TEST 
I I SS . R1 8 . NTH . SERVICES 
IISS.R18.UI.CLIB 
IISS. R18.UI. DRIVER 
IISS.R18.UI.FPAI 
IISS . R18 . CICS 
IISS.R18.CDM 


I PC  source  library 
NTM  MONITOR  source  library 
NTM  MPU  source  library 
NTM  TEST  source  library 
NTM  SERVICES  source  library 
'C'  utility  source  library 
UI/VTI  terminal  driver  library 
UI/FP  Appl .  Inter,  library 
CICS  Interface  source  library 
CDMP  Utility  source  library 


All  dataset  listed  between  the  rows  of  asterisks  will  have  a 
load  library  created  as  well  with  a  ' .LOADLIB'  concatenated 
to  the  dataset  najne. 


IISS  run  tine  sequential  datasets 


IISS .R18 . SYSGEN 
IISS.R18.NTML0G 
IISS . R18 . ERRLOG 
I I SS . R1 8 . HSTTBL 
IISS .R18 . APCTBL 
I ISS . R18 . APITBL 
IISS.R18 . APTTBL 
IISS .R18 . CATTBL 
IISS.R18 .DIRTBL 
IISS .R18 . LOGTBL 
I I SS . R1 8 . ACTTBL 
IISS .R18 . AUTTBL 
IISS .R18 . AGNTBL 
IISS.R18 . MRIWTI 
IISS .R18 . COIWTI 
IISS .R18 . UIIWTI 


System  Initialization  file 

Message  Log 

Error  Log 

Host  Status  Table 

A PC  Status  Table 

AP  Information  Table 

AP  Characteristics  Table 

Message  Category  Table 

AP  Directory  Table 

User  Logon  Table 

Message  Authority  Check  Table 

Message  Authority  Table 

Test  Data  Table 

Wai t ing-To-Ini tiate  Message  Queue 
Wai t ing-To-Ini tiate  Message  Queue 
Wai t ing-To-Ini tiate  Message  Queue 
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IISS .R18 .T1IWTI  Wai ting-To-Ini t late  Message  Queue 
IISS.R18 .OTHWTI  Wai tlng-To-Ini tlate  Message  Queue 
IISS.R18.0THDLQ  Message  Delivery  Queue 

IISS  run  time  VSAM  datasets 


IISS .R18 . APOTBL 
IISS .R18 . APSTBL 
IISS .R18 .CLDTBL 
IISS .RIB .MPRTBL 
IISS.R18. IATTBL 
IISS .R18 . GDMSGS 


AP  Operating  Information  Table 

AP  Status  Table 

AP  Child  Table 

Message  Pair  Table 

AP  I'm  Alive  Table 

Guaranteed  Delivery  Message  Queue 


IISS.R18.GRDSTS 

IISS .R18 . APCQUE 
IISS.R18.APQUE 


Guaranteed  Delivery  Message  Status 
Table 

OFF-APC  Message  Queue 
ON-APC  Message  Queue 
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